This is the appendix which outlines the basic use of iSquirrel. It provides instructions to get you started, registering with the system, logging onto the system and soon view tons of recommendations based on your interests.

\section{System requirements}

To use iSquirrel, your system should run 

\begin{itemize}
	\item A modern Operating System such as  Mac OS X, Linux, Windows.
	\item A standard compliant  web browser\footnote{Recommendations published by the World Wide Web Consortium: \\\indent \indent \url{http://www.w3.org/}} such as Firefox 3/3.5, Safari 3/4 or Chrome.
	\item JavaScript and cookies enabled.
	\item A broadband internet connection.
\end{itemize}

\section{Installation}
Since the system is a running on a web interface no installation is required prior to using the system. However, the system could run on a user's machine, locally, if Apache Tomcat\footnote{Apache Tomcat website: \url{http://tomcat.apache.org}}  6 is installed. If so, you can copy the WAR file iSquirrel.war in your Tomcat server's webapp directory and access iSquirrel using any browser on http://localhost:8080/iSquirrel\footnote{Depending on Tomcat's configurations the port may be different} while the Tomcat server is running. Running iSquirrel locally, also requires installing and running a PostgreSQL\footnote{The world's most advanced open source database: \url{http://www.postgresql.com}} client and server. 
\section{Using iSquirrel}

Assuming the existence of a published Tomcat server\footnote{The iSquirrel website: \url{http://websquirrel.net/iSquirrel}} with iSquirrel running or running your own local server with Tomcat installed, then you may start using the system.

\subsection{Getting started}

You should now be able to see the login screen of iSquirrel.

\subsubsection{User registration}

As a new iSquirrel user, our system requires the registration of new users and their authentication thereafter to be able to use the system.
By clicking on the \emph{Register} link, the system will redirect you to iSquirrel's registration page where you will be prompted to enter some personal information such as your name, date of birth  along with a username and a password of your choice.

Having filled the information required, pressing the \emph{Register} button should inform you that registration has been successful and ask you to drag your bookmarklet\footnote{More information about bookmarklets on \url{http://www.bookmarklets.com/about/}} on your browser's bookmarks toolbar.

\subsection{Facebook integration}

If you are a Facebook\footnote{The Facebook website:  \url{http://www.facebook.com}} user, then it is possible to speed up the registration process by clicking on the Facebook button to login.
Clicking on the Facebook button will initiate a popup prompting you to log onto Facebook using your Facebook credentials. These credentials cannot be stored on our system so rest assured that nobody will be accessing your Facebook page. Once you log in, most of your details, if not all, will have already been filled from your Facebook account. These details neither include your iSquirrel username nor password.
It is worth mentioning that if you are already logged in on Facebook on the same browser, the popup will quickly disappear, without prompting you for your Facebook credentials, and your details will still be filled.

\subsection{Internet bookmarklet}
Following a successful registration, you should now be able to drag your bookmarklet on your browsers bookmarks toolbar. 

Figure~\ref{bookmarklet1_screenshot} shows the state of the system after a successful registration where a user is asked to drag their bookmarklet onto their bookmarks toolbar.

\begin{figure}[H] 
	\begin{center}
	\includegraphics[width=4in]{resources/bookmarklet_1.pdf}
	\caption{Post-Registration Screen\label{bookmarklet1_screenshot} }
	\label{bookmarklet1_screenshot}
	\end{center}
\end{figure}

Figure~\ref{bookmarklet2_screenshot} shows the actual popup window when you click on the bookmark in your browser allowing you to \emph{``like"} Wikipedia Articles while on the go.
As you can see there are three different images acting as links. 

First and foremost is the one you need to click when you \emph{``like"} a Wikipedia\footnote{The Wikipedia website: \url{http://www.wikipedia.com}} article. The second one will produce a random Wikipedia article based on your interests and likes. If you haven't had the chance of setting your preferences, you won't be able to use this feature yet. The third and last image will automatically take you to your profile page without the need to log you in. The \emph{``i like"} link will be disabled while browsing non-Wikipedia websites. 

\begin{figure}[H] 
	\begin{center}
	\includegraphics[width=2.6in, height=1.82in]{resources/bookmarklet_2.pdf}
	\caption{The Bookmarklet in action\label{bookmarklet2_screenshot} }
	\label{bookmarklet2_screenshot}
	\end{center}
\end{figure}

\subsection{Interacting with the system}

This section will cover the main functionality and features of the system such as adding interests, viewing recommendations, liking recommendations, searching for friends and changing account settings.

\subsubsection{Adding interests}
\label{app-c-adding-interests}

As a new user you will be prompted to add new interests. Clicking on \emph{Add Interests} link will redirect you to \emph{Your Interests} page under the \emph{Profile} section where you will be asked to list all your interests. Feel free to add as many as you like. The more you enter the more recommendations you will get. Interest retrieval is based on Wikipedia entries so we apologise in advance for any interests that we might not be able to find. (Note: There might be a minor delay in adding the interest to the system.)  

Figure~\ref{adding_interest_gui_screenshot} illustrates the process of adding interests.
\begin{figure}[H] 
	\begin{center}
	\includegraphics[width=6in, height=2.33in]{resources/adding_interest_gui.pdf}
	\caption{Adding Interests on Your Profile\label{adding_interest_gui_screenshot} }
	\label{adding_interest_gui_screenshot}
	\end{center}
\end{figure}

\subsubsection{Recommendations}
Soon after your interests have been added you will be able to go back to the \emph{Recommendations} section where articles, music and videos will appear. You are free to browse as many recommendations as you want for as long as you want. As an extra feature, you are given the opportunity to say whether you like these recommendations by clicking on the \emph{``Liked!"} button. This allows the system to learn more about the articles you like to make your recommendations even more precise and tailored to your needs. 

Figure~\ref{liked_recommendation_screenshot} shows an article recommendation that a user liked.

\begin{figure}[H] 
	\begin{center}
	\includegraphics[width=6in]{resources/liked_recommendation.png}
	\caption{A liked article recommendation\label{liked_recommendation_screenshot} }
	\label{liked_recommendation_screenshot}
	\end{center}
\end{figure}

Figure~\ref{liked_utube_recommendation_screenshot} shows a video recommendation that a user liked.

\begin{figure}[H] 
	\begin{center}
	\includegraphics[width=6in]{resources/liked_utube_recommendation.pdf}
	\caption{A liked video recommendation\label{liked_utube_recommendation_screenshot} }
	\label{liked_utube_recommendation_screenshot}
	\end{center}
\end{figure}

\subsubsection{Friends}

The system allows a user to follow friends and track down what they have liked as well as check how closely related a user's profile is against another.
Clicking on the \emph{What your friends like} tab under the \emph{Recommendations} section, you will find recommendations that your friends like the most.
The \emph{Your network} section lists all the friends that you have chosen to follow as well as giving you the opportunity to search for other friends.

Using a sophisticated profile matching algorithm the system regularly suggests friends who have the same interests as yours or you can search for known friends. Searching for friends in iSquirrel is really easy. You can search for iSquirrel friends by name, username or even friends with a particular interest you might like and once found you are only a click away from being connected to your new friend.  In addition, you can also ``Connect with Facebook" and our system will magically search for your friends on Facebook who are currently registered onto iSquirrel.  If you have registered on iSquirrel using ``Facebook Connect" you will have already figured out that in doing so you will be following your Facebook friends who have been found on iSquirrel.

Figure~\ref{search_isquirrel_screenshot} shows how you can easily search for friends.

\begin{figure}[H] 
	\begin{center}
	\includegraphics[width=5in, height=1.4in]{resources/search_isquirrel.pdf}
	\caption{Searching for iSquirrel friends\label{search_isquirrel_screenshot} }
	\label{search_isquirrel_screenshot}
	\end{center}
\end{figure}

\subsubsection{Account settings}
The \emph{Account Settings} tab under the \emph{Profile} section lists all the information you can change, excluding your username. 
If you have accidentally deleted the bookmarklet from your browser's bookmarks toolbar, this is the place where you can retrieve it.

\section{Additional information}
If you are interested in learning more about iSquirrel and the technologies it uses, do not hesitate to contact any of the developers. 
We are always open to new ideas and would be interested in finding out if you encountered any bugs while using the system.

